Tracking Reference Objects
Tracking Reference Objects define the mode alignment and clocking targets for the spacecraft while tracking. Alignment is done in the Mode Controller, while clocking is done at run time (see Initial Conditions or Sequence Editor).
There are a variety of options for an axis of the spacecraft to point toward. Below are descriptions of all of the Targeting Reference Objects available in SOLIS.
Central Body
Object |
Description |
Sc -> Sun |
Points the spacecraft body (align or clock) axes with the spacecraft-to-Sun vector. |
SC -> Nadir (detic) |
Points the spacecraft body (align or clock) axis along the vector from the satellite to the local surface-normal of the selected central body. |
SC -> Nadir (centric) |
Points the spacecraft body (align or clock) axis along the vector from the satellite to the center of the selected central body reference frame. |
CB Orbit Normal |
Points the spacecraft body (align or clock) axis along the vector of the specified Central Body's orbit normal vector. This orbit normal vector is computed by taking the cross product of the Central Body's position and velocity. |
Target
Object |
Description |
SC -> Target Object |
Points the spacecraft body (align or clock) axis along the vector from the spacecraft to the specified Target Object. Target Objects can be locations on a central body, scans, or orbiting objects. You can change the definition of the target via the EPH_SET_TGT , EPH_SET_TGTSCAN , or EPH_ADD_ENTRY (for orbiting targets) commands. |
True North at Target |
Points the spacecraft body (align or clock) axis along the vector of True North at the location of the specified Target Object. |
Target velocity |
Points the spacecraft body (align or clock) axis along the vector of the specified Target Object inertial velocity. This is useful for scans to clock relative to (or orthogonal to) the scan direction. |
cross(SC -> TgtObject, SC Vel) |
Points the spacecraft body (align or clock) axis along the vector from the spacecraft to the vector cross product between the Target Object pointing vector and the spacecraft velocity. |
Spacecraft Parameters
Object |
Description |
SC Velocity |
Points the spacecraft body (align or clock) axis along the vector of the SC velocity. |
SC Mag Field |
Points the spacecraft body (align or clock) axis along the vector of the magnetic field at the location of the spacecraft. |
SC Orbit Normal |
Points the spacecraft body (align or clock) axis along the vector of the spacecraft's orbit normal vector. This orbit normal vector is computed by taking the cross product of the satellite's position and velocity. |
SC Relative Velocity |
Points the spacecraft body (align or clock) axis along the UCBF velocity vector. This differs from the UCBI velocity vector (SC Velocity) by incorporating the angular velocity of the central body axis rotation. |
True North |
Points the spacecraft body (align or clock) axis along the vector of True North at the subsatellite point. |
Inertial
Object |
Description |
Inertial Vector |
Points the spacecraft body (align or clock) axis along the inertial vector specified. |
Inertial Fixed |
Orients the spacecraft in a specified inertial (True of Date) attitude using a quaternion or direction cosine matrix (DCM). |
External
Object |
Description |
External Guidance |
Points the spacecraft body in a quaternion orientation (CBI2BDY) defined over the ExternalGuidance interface connected to the FOB_ModeType_Tracking . The interface also provides the BDY angular velocity command and the BDY angular acceleration command. This allows you to fully determine the guidance commands using any custom logic you desire.
This Reference Object is not valid as a Clocking Option. |
External Vector |
Points the spacecraft body (align or clock) axis in the UCBI vector specified by the ExternalAlignVector or ExternalClockVector interface connected to the FOB_ModeType_Tracking object. This enables you to define any logic you desire to create the UCBI vector. You must make the interface connection via Connection_FSC_Gui_Vec_A . |